<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
<html lang="zh-CN"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta http-equiv="Content-Language" content="zh-CN"><link href="stylesheet.css" media="all" rel="stylesheet" type="text/css">
<title>createdb</title>
<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script>
</head><body class="REFENTRY">
<div>
<table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><th colspan="5" align="center" valign="bottom">PostgreSQL 8.2.3 中文文档</th></tr>
<tr><td width="10%" align="left" valign="top"><a href="app-clusterdb.html" accesskey="P">后退</a></td><td width="10%" align="left" valign="top"><a href="app-clusterdb.html">快退</a></td><td width="60%" align="center" valign="bottom"></td><td width="10%" align="right" valign="top"><a href="app-createlang.html">快进</a></td><td width="10%" align="right" valign="top"><a href="app-createlang.html" accesskey="N">前进</a></td></tr>
</table>
<hr align="LEFT" width="100%"></div>
<h1><a name="APP-CREATEDB"></a><span class="APPLICATION">createdb</span></h1>
<div class="REFNAMEDIV"><a name="AEN55568"></a><h2>名称</h2>createdb&nbsp;--&nbsp;创建一个新数据库</div>
<a name="AEN55572"></a>
<div class="REFSYNOPSISDIV"><a name="AEN55574"></a><h2>语法</h2>
<p><tt class="COMMAND">createdb</tt> [<tt class="REPLACEABLE"><i>option</i></tt>...] [<tt class="REPLACEABLE"><i>dbname</i></tt>] [<tt class="REPLACEABLE"><i>description</i></tt>]</p>
</div>
<div class="REFSECT1"><a name="R1-APP-CREATEDB-1"></a><h2>描述</h2>
<p><span class="APPLICATION">createdb</span> 创建一个新 PostgreSQL 数据库。</p>
<p>通常，执行这个命令的数据库用户将成为新数据库的所有者。不过，如果拥有合适的权限，那么也可以通过 <tt class="OPTION">-O</tt> 指定其它用户。</p>
<p><span class="APPLICATION">createdb</span> 是一个 SQL 命令 <a href="sql-createdatabase.html"><i>CREATE DATABASE</i></a> 的封装。因此，两种方法创建的数据库都一样。</p>
</div>
<div class="REFSECT1"><a name="AEN55594"></a><h2>选项</h2>
<p><span class="APPLICATION">createdb</span> 接受下列命令行参数：</p>
<div class="VARIABLELIST">
<dl>
<dt><tt class="REPLACEABLE"><i>dbname</i></tt></dt>
<dd><p>要创建的数据库名。该名称应该在本节点的所有数据库里面必须是唯一的。缺省是与当前系统用户同名。</p></dd>
<dt><tt class="REPLACEABLE"><i>description</i></tt></dt>
<dd><p>这个选项声明一个与新创建的数据库相关的注解</p></dd>
<dt><tt class="OPTION">-D <tt class="REPLACEABLE"><i>tablespace</i></tt></tt><br><tt class="OPTION">--tablespace <tt class="REPLACEABLE"><i>tablespace</i></tt></tt></dt>
<dd><p>指定数据库的缺省表空间</p></dd>
<dt><tt class="OPTION">-e</tt><br><tt class="OPTION">--echo</tt></dt>
<dd><p>回显 <span class="APPLICATION">createdb</span> 生成并它发送到服务器的命令。</p></dd>
<dt><tt class="OPTION">-E <tt class="REPLACEABLE"><i>encoding</i></tt></tt><br><tt class="OPTION">--encoding <tt class="REPLACEABLE"><i>encoding</i></tt></tt></dt>
<dd><p>声明此数据库的字符编码。PostgreSQL 服务器支持的字符集在<a href="multibyte.html#MULTIBYTE-CHARSET-SUPPORTED">节21.2.1</a>里列出。</p></dd>
<dt><tt class="OPTION">-O <tt class="REPLACEABLE"><i>owner</i></tt></tt><br><tt class="OPTION">--owner <tt class="REPLACEABLE"><i>owner</i></tt></tt></dt>
<dd><p>指定将拥有新数据库的用户</p></dd>
<dt><tt class="OPTION">-q</tt><br><tt class="OPTION">--quiet</tt></dt>
<dd><p>不显示响应(安静模式)</p></dd>
<dt><tt class="OPTION">-T <tt class="REPLACEABLE"><i>template</i></tt></tt><br><tt class="OPTION">--template <tt class="REPLACEABLE"><i>template</i></tt></tt></dt>
<dd><p>声明创建此数据库的模板数据库</p></dd>
</dl>
</div>
<p>选项 <tt class="OPTION">-D</tt>, <tt class="OPTION">-E</tt>, <tt class="OPTION">-O</tt>, <tt class="OPTION">-T</tt> 对应底层 SQL 命令 <a href="sql-createdatabase.html"><i>CREATE DATABASE</i></a> 的选项，更多信息可以参考该命令的手册页。</p>
<p><span class="APPLICATION">createdb</span> 还接受下列命令行参数作为连接参数：</p>
<div class="VARIABLELIST">
<dl>
<dt><tt class="OPTION">-h <tt class="REPLACEABLE"><i>host</i></tt></tt><br><tt class="OPTION">--host <tt class="REPLACEABLE"><i>host</i></tt></tt></dt>
<dd><p>指定运行服务器的主机名。如果数值以斜杠开头则被用作到 Unix 域套接字的路径。</p></dd>
<dt><tt class="OPTION">-p <tt class="REPLACEABLE"><i>port</i></tt></tt><br><tt class="OPTION">--port <tt class="REPLACEABLE"><i>port</i></tt></tt></dt>
<dd><p>服务器侦听的 TCP 端口或一个本地 Unix 域套接字文件的扩展(描述符)</p></dd>
<dt><tt class="OPTION">-U <tt class="REPLACEABLE"><i>username</i></tt></tt><br><tt class="OPTION">--username <tt class="REPLACEABLE"><i>username</i></tt></tt></dt>
<dd><p>进行连接的用户名</p></dd>
<dt><tt class="OPTION">-W</tt><br><tt class="OPTION">--password</tt></dt>
<dd><p>强制口令提示符</p></dd>
</dl>
</div>
</div>
<div class="REFSECT1"><a name="AEN55706"></a><h2>环境变量</h2>
<div class="VARIABLELIST">
<dl>
<dt><tt class="ENVAR">PGDATABASE</tt></dt>
<dd><p>如果设置了，那么就是要创建的数据库名字，除非在命令行上进行了覆盖。</p></dd>
<dt><tt class="ENVAR">PGHOST</tt><br><tt class="ENVAR">PGPORT</tt><br><tt class="ENVAR">PGUSER</tt></dt>
<dd><p>缺省连接参数。如果没有在命令行上声明数据库名字，也没有用 <tt class="ENVAR">PGDATABASE</tt> 声明的话，<tt class="ENVAR">PGUSER</tt> 还决定了要创建的数据库名字。</p></dd>
</dl>
</div>
</div>
<div class="REFSECT1"><a name="AEN55725"></a><h2>诊断</h2>
<p>如果出现错误，将会显示后端错误信息。参阅 <a href="sql-createdatabase.html"><i>CREATE DATABASE</i></a> 和 <a href="app-psql.html"><span class="APPLICATION">psql</span></a> 获取可能信息描述。数据库服务器必须在目标服务器上运行。同样，前端库 <span class="APPLICATION">libpq</span> 使用的缺省连接设置和环境变量都将适用。</p>
</div>
<div class="REFSECT1"><a name="AEN55731"></a><h2>例子</h2>
<p>用缺省数据库服务器创建一个 <tt class="LITERAL">demo</tt> 数据库：</p>
<pre class="SCREEN"><samp class="PROMPT">$ </samp><kbd class="USERINPUT">createdb demo</kbd>
<samp class="COMPUTEROUTPUT">CREATE DATABASE</samp></pre>
<p>应答将会和运行 <tt class="COMMAND">CREATE DATABASE</tt> 命令的结果相同。</p>
<p>在主机 <tt class="LITERAL">eden</tt> 上创建 <tt class="LITERAL">demo</tt> 数据库，端口是 5000 ，使用 <tt class="LITERAL">LATIN1</tt> 编码方式，并且显示执行的命令：</p>
<pre class="SCREEN"><samp class="PROMPT">$ </samp><kbd class="USERINPUT">createdb -p 5000 -h eden -E LATIN1 -e demo</kbd>
<samp class="COMPUTEROUTPUT">CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'</samp>
<samp class="COMPUTEROUTPUT">CREATE DATABASE</samp></pre>
</div>
<div class="REFSECT1"><a name="AEN55750"></a><h2>又见</h2><a href="app-dropdb.html"><span class="APPLICATION">dropdb</span></a>, <a href="sql-createdatabase.html"><i>CREATE DATABASE</i></a>, 环境变量(<a href="http://www.jinbuguo.com/postgresql/manual/libpq-envars.html">节29.12</a>)</div>
<div>
<hr align="LEFT" width="100%">
<table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><td width="33%" align="left" valign="top"><a href="app-clusterdb.html" accesskey="P">后退</a></td><td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">首页</a></td><td width="33%" align="right" valign="top"><a href="app-createlang.html" accesskey="N">前进</a></td></tr>
<tr><td width="33%" align="left" valign="top"><span class="APPLICATION">clusterdb</span></td><td width="34%" align="center" valign="top"><a href="reference-client.html" accesskey="U">上一级</a></td><td width="33%" align="right" valign="top"><span class="APPLICATION">createlang</span></td></tr>
</table>
</div>
</body></html>